Skip to content

solid26: placeholder for access-control language pending CG consensus#785

Open
jeswr wants to merge 5 commits intosolid26from
feat/solid26-access-control-placeholder
Open

solid26: placeholder for access-control language pending CG consensus#785
jeswr wants to merge 5 commits intosolid26from
feat/solid26-access-control-placeholder

Conversation

@jeswr
Copy link
Copy Markdown
Member

@jeswr jeswr commented Apr 26, 2026

A preview link can be found here.

Purpose

Replaces the WAC/ACP content in §2 with placeholder text marked "subject to discussion before inclusion" so the wider Solid26 launch can proceed without holding on the unresolved access-control-language wording. The proposed access-control-language text itself is being worked on in #783 and will land here once consensus is reached.

What's in this PR

  • Top-of-document notice — states the whole document is a draft, with §Web Access Control and §Access Control Policy at primary risk.
  • §2 specifications table — WAC version cell becomes "Subject to discussion before inclusion"; new ACP row added with the same.
  • TOC — §2.4 Access Control Policy added; WebID 1.0 and Solid WebID Profile renumbered to §2.5 / §2.6.
  • §2.1 Solid Protocol commentary — the WAC-encouragement bullet and the March 2026 survey note are replaced with a placeholder bullet pointing at §2.3 / §2.4. The "Some Clients…" architectural-separation bullet is kept.
  • §2.3 Web Access Control and §2.4 Access Control Policy (new) — both contain class="issue" placeholder boxes pointing at solid26: draft WAC/ACP wording for CG discussion #783.

Review

@uvdsl as co-editor most directly affected by the placeholder approach — does this shape work for you, or want to adjust before we land it?

Test plan

  • Render solid26.html and confirm the four class="issue" boxes (top-of-doc banner, §2.1 bullet, §2.3, §2.4) render visually distinct.
  • §2 specifications table shows "Subject to discussion before inclusion" for WAC and ACP rows.
  • TOC shows §2.4 Access Control Policy and renumbered §2.5 / §2.6.

jeswr added 4 commits April 26, 2026 16:15
Adds a top-of-document warning banner and replaces the WAC/ACP
content in §2 with placeholders marked 'subject to discussion before
inclusion':

- §SOTD: warning banner pointing at the affected sections and #783.
- §2 specifications table: WAC version cell becomes 'Subject to
  discussion before inclusion'; new ACP row added with the same.
- TOC: §2.4 Access Control Policy added; WebID 1.0 and Solid WebID
  Profile renumbered to §2.5/2.6.
- §2.1 Solid Protocol commentary: WAC-encouragement bullet, the
  March 2026 survey note, and the architectural-separation bullet
  are removed and replaced with a one-line pointer to §2.3 / §2.4.
- §2.3 Web Access Control: content replaced with a 'subject to
  discussion before inclusion' warning, pointing at PR #783.
- §2.4 Access Control Policy (new): same placeholder structure.

Allows the wider Solid26 launch to proceed without holding on the
unresolved WAC/ACP wording. Once #783 reaches consensus, this
placeholder branch will be replaced with the agreed text.
Keep the architectural-separation guidance for Clients managing
access controls; only the WAC/ACP-encouragement bullet and the
March 2026 survey note remain replaced by the placeholder.
Visual consistency with the placeholders in §2.3 and §2.4.
The W3C base stylesheet styles .note and .issue but not .warning, so
the previous placeholders rendered without a visual box. Switch all
four to class="issue".

Also broaden the top-of-doc banner: state explicitly that the whole
document is a draft so all parts may change, with the highlighted
'subject to discussion' sections (§Web Access Control and §Access
Control Policy) at primary risk.
Copy link
Copy Markdown
Member

@uvdsl uvdsl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Either the document will be published reflecting CG consensus or it will not be published. Adding such a note of missing consensus (in-fact even agreement), while declaring that it is published by the W3C Solid CG, is a contradiction.

This document is not yet published and is proposed as a PR where editing is actively taking place. It is a work in progress, that is quite apparent.

If you want to publish this document, then it is you (or an organization) who publishes the document. That published document MUST NOT declare that it is published or even endorsed by the CG because it is not. The proposed change is unfit to for that purpose.

From the description of this PR, I don't quite grasp the goal here? Could you clarify?


I note that this PR tries to add in ACP as a recommended access control language here again, which is unnecessary (as a different PR tries to do that already) and not reflecting agreement of the group (#783 (comment)).

@jeswr
Copy link
Copy Markdown
Member Author

jeswr commented Apr 27, 2026

I was of the understanding that the CG was not at consensus on the text around access control -- for the reasons that @elf-pavlik just identified on the mailing list (see below).

The goal of this PR is to have a draft copy of the document that we are all comfortable pointing people to for the duration of this week; by omitting those topics still under discussion. I will make some suggested changes removing text that implies this document is published.

This PR does not even need to be merged. I just would like to have a document where the preview link (https://htmlpreview.github.io/?https://github.com/solid/specification/blob/feat/solid26-access-control-placeholder/solid26.html) contains text we can agree on.

I note that this PR tries to add in ACP as a recommended access control language here again, which is unnecessary (as a different PR tries to do that already) and not reflecting agreement of the group (#783 (comment)).

It adds it with a note that the section could be removed from the spec; since there is not currently consensus on whether or not it would be in.

Hi Christoph,

I'm writing from mobile mostly to ask for a quick clarification on CG process.

https://www.w3.org/community/solid/charter/#decision-policy

"To afford asynchronous decisions and organizational deliberation, any resolution (including publication decisions) taken in a face-to-face meeting or teleconference will be considered provisional. A call for consensus (CfC) will be issued for all resolutions (for example, via email, GitHub issue, or web-based survey), with a response period of five to ten working days, depending on the chair’s evaluation of the group consensus on the issue. If no objections are raised by the end of the response period, the resolution will be considered to have consensus as a resolution of the Community Group."

My understanding is that we were using GitHub PRs for that, even without explicitly calling it out, and objections were raised by multiple people.

I would also note https://github.com/solid/specification/blob/main/meetings/2026-04-01.md#wac--acp

"SC: Maybe, give the group the opportunity to voice (dis-)comfort with this result and messaging?"

Certain discomfort seems to have been voiced.

Even without reading the CG charter. My common sense tells me that CG doesn't have consensus on this issue. We clearly don't agree and the whole ongoing conversation can be seen as evidence.

We already were planning to communicate Solid 26 as something that is still being finalized. This issue seems like one of the points that in the end we may note as something that we didn't reach consensus on.

Given ongoing Solid Week I would suggest that we only try to agree on how this work in progress can be communicated.

Best,
elf Pavlik

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants